home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / ASSEMBLE / 0938.ZIP / BXD.DOC < prev    next >
Text File  |  1987-08-22  |  4KB  |  101 lines
  1.  
  2.          b r a n d X  S Y M B O L I C  D E B U G G E R
  3.                          version 1.0
  4.  
  5.                       by  Sonam G Gyato
  6.  
  7. BRIEF INTRODUCTION:
  8.  
  9. This program is a software debugger for the IBM pc/AT and other
  10. close compatibles. It will work with both PC and MS DOS versions
  11. later than 2.1. This version supports both the MONOCHROME (MDA)
  12. and the 80x25 text modes of COLOR GRAPHICS ADAPTOR (CGA). Since
  13. bXd is a full-screen debugger, it traps all bios video calls and
  14. buffers the output to it's own memory location. In the case of
  15. the CGA, you have simultaneous access to the four display pages.
  16.  
  17. Two main criterias have been taken into account in the design of
  18. this software:
  19.      user interface
  20.           full-screen display; extensive online help with all the
  21.           available commands; "intelligent" disassembly of code;
  22.           access variables by symbol names plus more.
  23.  
  24.      simplicity versus power
  25.           This is a difficult catch-22 choice for software
  26.           designers. Make it simple...it has little power,
  27.           make it powerful...it becomes difficult to use. bXd
  28.           follows the middle road. It is simple enough to learn
  29.           in one session and yet capable enough to debug complex
  30.           programs.
  31.  
  32.  
  33. INTRODUCTION:
  34.  
  35. The best way to learn this program is by using it. After loading
  36. the program, press function-key #9. This will display the help
  37. menu and enable you to get help on any of the displayed commands.
  38.  
  39. If you are using bXd for the first time, it is recommended that
  40. you go through all the commands at least once. This document will
  41. assume that you will do so and not explain it here.
  42.  
  43.  
  44. STARTING bXd:
  45.  
  46. Below is an example of invoking bXd from the DOS prompt.
  47.  
  48.      A>bXd [userprog[.COM]] [user_arguments] [<userCON.txt]
  49.  
  50. 1.   The first argument is the optional name of the program to be
  51.      debugged. If no extension is given, then a COM file is
  52.      assumed. In the case of EXE files, you have to specify the
  53.      extension explicitly.
  54.  
  55.      If a filename is given, then bXd tries to load the symbol
  56.      file associated with it. The name of the symbol file is
  57.      derived from the given filename and the extension SYM.
  58.      More on the symbol file format later.
  59.  
  60. 2.   The second set of arguments is what will be passed to your
  61.      program as its command line. This text is found at offset
  62.      81H in your programs PSP (read DOS tech manual for more
  63.      information on PSPs).
  64.  
  65. 3.   The last argument enables you to redirect the input and
  66.      output to another device besides the console. This might be
  67.      of some help if you're debugging a program that expects
  68.      input from DOS console i/o routines.
  69.  
  70.                                ===
  71.  
  72. FUTURE RELEASE PROPOSALS:
  73.  
  74. This is the first release of bXd and I am very much interested in
  75. receiving feedback from the users. I am particularly interested
  76. in features you find awkward to use, better user-interface
  77. and commands you would like implemented. For example, would you
  78. like the debugger to track the instructions being executed (hmmm?).
  79.  
  80. Below are some new features that are planned for the next
  81. and hopefully final release.
  82.  
  83.      One of the major additions is a Non-Maskable-Interrupt reset
  84.      button (this requires a little hardware tinkering). This
  85.      will be of great help towards debugging. Press the button
  86.      and the program being debugged will be interrupted by bXd.
  87.  
  88.      Full support of the CGA. With this you will be able to debug
  89.      graphics programs. There will also be a facility to write to
  90.      text mode screens "pseudo" directly.
  91.  
  92.      I am also thinking about making the debugger a resident
  93.      program which will be activated by the previously mentioned
  94.      NMI reset button. This will require the user program and
  95.      symbol table loader to be a separate file. The source code
  96.      for this file will be supplied. You can then modify this
  97.      program to load a symbol table compatible with your linker.
  98.  
  99.  
  100. [SGG 05/13/86]
  101.